start

Scripting

Important variables

• world
• player
• living (a player or mob the player is interacting with)
• origin (the position where you have clicked, destroyed,... a block)
• side (the side you have clicked with an item)
• customstuff
• blockID (provides blockIds)
• itemID (provides itemIds)
• weather (provides weatherIds)

Functions

Category	Function	Description	Arguments
world	setBlockId	Sets the ID of the block	Position pos, int id
	setBlockMetadata	Sets the metadata of the block	Position pos, int metadata
	setBlockIdAndMetadata	Sets the ID and metadata of the block	Position pos, int id, int metadata
	harvestBlock	Harvests the block	Position pos
	setTime	Sets the time	int time
	createExplosion	Rips angry creepers apart	Position pos, float stenght
	createThunderbolt	Creates thunderbolt	Position pos
	spawnMob	Spawns mob	Position pos, String name
	spawnItem	Spawns item	Position pos, int id, int count, int damage
	setWeather	Sets weather	int weather, int time
	hoeBlock	Hoes your block	Position pos
	fillContainer	Fills container with x	Position pos, int id, int damage
	clearContainer	Clears container from x	Position pos
	addToContainer	Adds x to container	Position pos, int id, int count, int damage
	removeFromContainer	Removes x to container	Position pos, int id, int count, int damage
	clearContainerSlot	Clears container slot	Position pos, int slotId
	fillContainerSlot	Fills container slot	Position pos, int slotId
	setContainerSlot	Sets container slot to x	Position pos, int slotId, int id, int count, int damage
	removeFromContainerSlot	Removes x from the container slot	Position pos, int slotId, int count
	addToContainerSlot	Adds x to the container slot	Position pos, int slotId, int count
	getBlockId	Gets block ID	Position pos
	getBlockDamage	Gets block damage	Position pos
	getContainerSlotId	Gets container's slot Item ID	Position pos, int slotId
	getContainerSlotDamage	Gets container's slot Item damage	Position pos, int slotId
	getContainerSlotCount	Gets container's slot Item count	Position pos, int slotId
	getContainerItemCount	Gets container's item count	Position pos, int id, int damage
player	move	Moves player	Position pos
	setPosition	Sets player position	Position pos
	dropItem	Spawns an item next to the player.	int id, int count, int damage
	setHealth	Sets player health to x	int health
	addVelo	Pokes player from behind with x velocity	double x, double y, double z
	getPosition	Gets player's position
	getHealth	Gets player's health
	getHunger	Gets player's hunger
	getSaturation	Gets player's saturation
	setHunger	Sets player's hunger	int amount
	addHunger	Adds player's hunger	int amount
	setSaturation	Sets player's saturation	float amount
	addSaturation	Adds player's saturation	float amount
	getLookingSide	"Hey, what are you looking at?"
	sendMessage	Sends player a message	string message
	clearInventory	Clears player's inventory
	fillInventory	Fills player's inventory	int id, int damage
	addToInventory	Adds x to player's inventory	int id, int count, int damage
	removeFromInventory	Removes x from player's inventory	int id, int count, int damage
	clearInventorySlot	Clears inventroy slot	int slotId
	fillInventorySlot	Fills inventory slot	int slotId
	setInventorySlot	Sets inventory slot to x	int slotId, int id, int count, int damage
	removeFromInventorySlot	Removes x from the inventory slot	int slotId, int count
	addToInventorySlot	Adds x to theinventory slot	int slotId, int count
	damageItem	"hey,dont break my %item_name%!!!"	int slotId, int damage
	placeBlock	Places block	Position pos, int id, int damage, int side
	getCurrentSlot	Gets current slotid
	getItemId	Gets item id	int slotId
	getItemStackSize	Gets item stack size	int slotId
	getItemDamage	Gets item damage	int slotId
	getMaxItemDamage	Gets max item damage	int slotId
	getItemCount	Gets item count	int id, int damage
living	move	Moves mob	Position pos
	setPosition	Sets mob position	Position pos
	dropItem	Drops item from mob	int id, int count, int damage
	setHealth	Sets mob's health to x	int health
	addVelo	Pokes mob from behind with x velocity	double x, double y, double z
	getPosition	Gets mob position
	getHealth	Gets mob health
	getLookingSide	"dont look at me like that!"
customstuff	loadScript	Loads external script	String file
	wait	Waits	int millis

Examples

world.setBlockId(origin, blockID.STONE); // this will set the block at origin to stone

world.setBlockIdAndMetadata(origin, blockID.WOOL, 14); // this will set the block at origin to red wool

origin.y += 1;
world.setBlockId(origin, blockID.STONE); // this will set the block one block above the origin to stone

player.fillInventory(blockID.DIRT, 0); // this will fill up the players inventory with dirt.

customstuff.loadScript('123.script'); // this will execute the '123.script' in the customStuffFunctions folder.

if (world.getBlockId(origin) == blockID.DIRT)
{
    world.setBlockId(origin, blockID.STONE);
}
// this will set the block at origin to stone if the block at origin is a dirt block.

[additional notes]